`:top

Eine `!Java-Properties-Datei`! ist eine `F33f`_`[Konfigurationsdatei`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Konfigurationsdatei]`_`f, die hauptsächlich zur Speicherung von Anwendungsdaten im Umfeld der Programmiersprache `F33f`_`[Java`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Java_(Programmiersprache)]`_`f verwendet wird. Eine `*Property`* (deutsch „Eigenschaft“) ist in diesem Zusammenhang ein Text, der unter einem bestimmten Namen abgelegt ist. Java-Properties-Dateien haben üblicherweise die `F33f`_`[Dateiendung`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Dateiendung]`_`f `B100`F9d9.properties`f`b.

>>Contents

• `F0af`_`[Struktur`#struktur]`_`f

• `F0af`_`[Verwendung in Java-Programmen`#verwendung-in-java-programmen]`_`f

• `F0af`_`[Platzhalter`#platzhalter]`_`f

• `F0af`_`[Internationalisierung`#internationalisierung]`_`f

• `F0af`_`[Einzelnachweise`#einzelnachweise]`_`f

-─

>>Struktur

Das folgende Beispiel zeigt einen Ausschnitt aus einer einfachen Konfigurationsdatei:

`B100`F9d9# Dies ist ein Kommentar`f`b

`B100`F9d9! Dies ist ebenfalls ein Kommentar`f`b

`B100`F9d9wenig Text`f`b

`B100`F9d9pi = 3.14`f`b

`B100`F9d9lang:de`f`b

`B100`F9d9vieltext Dieser Text \\`f`b

`B100`F9d9 läuft über zwei Zeilen.`f`b

`B100`F9d9paramText = Text mit dynamischem Parameter: {0}`f`b

`B100`F9d9unicodeText = Ein Smiley: \\u263A`f`b

Das Beispiel enthält zwei `F33f`_`[Kommentarzeilen`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Kommentar_(Programmierung)]`_`f und definiert sechs Werte für die Namen `B100`F9d9wenig`f`b, `B100`F9d9pi`f`b, `B100`F9d9lang`f`b, `B100`F9d9vieltext`f`b, `B100`F9d9paramText`f`b und `B100`F9d9unicodeText`f`b.

Wie sich aus dem Beispiel erkennen lässt, gibt es Kommentarzeilen, die mit einem `F33f`_`[Rautezeichen`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Rautezeichen]`_`f `B100`F9d9#`f`b oder einem `F33f`_`[Ausrufezeichen`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Ausrufezeichen]`_`f `B100`F9d9!`f`b beginnen, und Datenzeilen, in denen ein Name und ein Text definiert werden.`:cite-ref-store-1-0[`F5bf`_`[1`#cite-note-store-1]`_`f]

Name und Text können auf drei Arten voneinander getrennt werden, wobei die Trennzeichen nicht zum Schlüssel oder Text gehören.`:cite-ref-store-1-1[`F5bf`_`[1`#cite-note-store-1]`_`f]

1. durch ein oder mehrere `F33f`_`[Leerzeichen`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Leerzeichen]`_`f: Im obigen Beispiel hat der Schlüssel `B100`F9d9wenig`f`b den Wert „Text“, entsprechend `B100`F9d9vieltext`f`b.

2. durch ein `F33f`_`[Gleichheitszeichen`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Gleichheitszeichen]`_`f `B100`F9d9=`f`b, umgeben von keinem oder beliebig vielen Leerzeichen: Im obigen Beispiel hat der Schlüssel `B100`F9d9pi`f`b den Wert „3.14“.

3. durch einen `F33f`_`[Doppelpunkt`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Doppelpunkt]`_`f `B100`F9d9:`f`b, umgeben von keinem oder beliebig vielen Leerzeichen: Im obigen Beispiel hat der Schlüssel `B100`F9d9lang`f`b den Wert „de“.

Ein `F33f`_`[umgekehrter Schrägstrich`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Umgekehrter_Schrägstrich]`_`f `B100`F9d9\\`f`b am Ende der Zeile bedeutet, dass der Text in der nächsten Zeile fortgesetzt wird.`:cite-ref-store-1-2[`F5bf`_`[1`#cite-note-store-1]`_`f] Stehen am Ende der Zeile mehrere umgekehrte Schrägstriche, wird der Text nur dann in der nächsten Zeile fortgesetzt, wenn die Anzahl der Schrägstriche ungerade ist. Endet die Zeile z. B. auf `B100`F9d9\\\\`f`b, so reicht der Text nur bis zum Ende der Zeile und enthält am Ende einen umgekehrten Schrägstrich; endet die Zeile hingegen auf `B100`F9d9\\\\\\`f`b, dann wird der Text in der nächsten Zeile fortgesetzt.`:cite-ref-store-1-3[`F5bf`_`[1`#cite-note-store-1]`_`f]

Als Zeichencodierung für den Text wird `F33f`_`[ISO 8859-1`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=ISO_8859-1]`_`f verwendet. Unicode-Zeichen, die nicht im ISO-Encoding enthalten sind, müssen mit einer `F33f`_`[Escape-Sequenz`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Escape-Sequenz]`_`f codiert werden.`:cite-ref-store-1-4[`F5bf`_`[1`#cite-note-store-1]`_`f]

>>Verwendung in Java-Programmen

Eine solche Java-Properties-Datei kann mittels der `F33f`_`[Klasse`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Klasse_(Objektorientierung)]`_`f `B100`F9d9java.util.Properties`f`b eingelesen werden. Anschließend können die definierten Werte über deren `F33f`_`[Methoden`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Methode_(Programmierung)]`_`f abgefragt werden. Das folgende Code-Fragment erzeugt ein Properties-Objekt, liest eine Datei namens `B100`F9d9beispiel.properties`f`b ein, und legt den Wert der Property `B100`F9d9lang`f`b in einer Variablen namens `B100`F9d9sprache`f`b ab.

`B100`F9d9import java.io.FileInputStream;`f`b

`B100`F9d9import java.io.BufferedInputStream;`f`b

`B100`F9d9import java.util.Properties;`f`b

`B100`F9d9…`f`b

`B100`F9d9Properties properties = new Properties();`f`b

`B100`F9d9BufferedInputStream stream = new BufferedInputStream(new FileInputStream("beispiel.properties"));`f`b

`B100`F9d9properties.load(stream);`f`b

`B100`F9d9stream.close();`f`b

`B100`F9d9String sprache = properties.getProperty("lang");`f`b

Bei der `B100`F9d9load`f`b-Methode muss die `F33f`_`[Ausnahme`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Ausnahmebehandlung]`_`f `B100`F9d9IOException`f`b abgefangen werden. Der Übersicht wegen wurde der Try-Catch-Block weggelassen.

>>Platzhalter

Eine `F33f`_`[nicht negative`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Positive_und_negative_Zahlen]`_`f `F33f`_`[ganze Zahl`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Ganze_Zahl]`_`f in geschweiften Klammern `B100`F9d9{}`f`b steht für einen Text, der zur `F33f`_`[Laufzeit`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Laufzeit_(Informatik)]`_`f des Programms ergänzt werden soll. Sinnvollerweise beginnen die Zahlen in den Klammern mit `B100`F9d90`f`b und sind fortlaufend. Sie dürfen mehrfach sowie in beliebiger `F33f`_`[Reihenfolge`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Reihenfolge]`_`f auftreten. Solche Ersetzungen sind für die `F33f`_`[Internationalisierung`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Internationalisierung_(Softwareentwicklung)]`_`f oder `F33f`_`[Lokalisierung`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Lokalisierung_(Softwareentwicklung)]`_`f von Programmen sinnvoll, wo dynamisch zu erzeugende Textbestandteile in unterschiedlichen `F33f`_`[Sprachen`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Sprache]`_`f an unterschiedlichen Stellen oder in unterschiedlicher Reihenfolge auszugeben sind.

Die Ersetzung des Parameters kann mit folgendem Code realisiert werden:

`B100`F9d9String paramText = properties.getProperty("paramText");`f`b

`B100`F9d9String dynText = "dynamisch eingesetzter Text";`f`b

`B100`F9d9System.out.println(MessageFormat.format(paramText,dynText));`f`b

Ausgabe:

`B100`F9d9Text mit dynamischem Parameter: dynamisch eingesetzter Text`f`b

Bei mehreren Ersetzungsparametern muss für „dynText“ ein `F33f`_`[Array`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Array_(Datentyp)]`_`f oder eine `F33f`_`[Menge`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Menge_(Datenstruktur)]`_`f mit den Ersetzungswerten übergeben werden.

Streng genommen ist dies kein Feature des Properties-Mechanismus, wird hier jedoch erwähnt, da es in diesem Zusammenhang vielfach Verwendung findet.

>>Internationalisierung

Ein weiteres Feature des Properties-Mechanismus in Java ist das Aufteilen der Inhalte pro `F33f`_`[Locale`:/page/entry.mu`zim=wikipedia_de_all_nopic_2026-01.zim|entry_path=Locale]`_`f. Das macht man durch ein Suffix im Dateinamen kenntlich. Eine Properties-Datei `B100`F9d9messages.properties`f`b speziell für deutschsprachige Texte würde man `B100`F9d9messages_de.properties`f`b benennen. Das kann man mit der Angabe einer Region noch weiter eingrenzen. Eine Property-Datei für österreichisches Deutsch würde demnach so benannt: `B100`F9d9messages_de_AT.properties`f`b. Eine Variante ohne Suffix sollte als Fallback möglichst immer vorhanden sein. Seit Java 9 werden ResourceBundles-Properties standardmäßig mit UTF-8 decodiert, wodurch die unleserlichen Escape-Sequenzen entfallen können. Sollten beim Dekodieren Probleme auftreten, wird es mit ISO 8859-1 automatisch erneut versucht.`:cite-ref-2[`F5bf`_`[2`#cite-note-2]`_`f]

>>Einzelnachweise

`:cite-note-store-1`!1.`! `F0af`_`[↑`#cite-ref-store-1-0]`_`f `*Properties`*. Java API Specification

`:cite-note-2`!2.`! `F0af`_`[↑`#cite-ref-2]`_`f `*JEP 226: UTF-8 Property Resource Bundles.`* Abgerufen am 22. Juni 2020.

`c`F0af`_`[↑ Back to top`#top]`_`f`a